Initiate a properties change on the Task Server in the specified group.
URL Parameters
group-id
The id or name of the group to which the Task
Server belongs. This parameter is required.
format
The format of the data in the request body. Can be
json or xml. If present, the format parameter
overrides the request Content-type header.
Request Headers
Accept
The expected MIME type of the response. If the
format parameter is present, it takes precedence over the Accept header.
Supported values: application/xml, application/json.
Content-type
The MIME type of the data in the request
body, either application/xml or application/json.
Response Headers
Content-type
The MIME type of the data in the response
body. Use the Accept header or format request parameter to specify a preferred
format. The format parameter takes precedence over the Accept header if both
are present.
Response
Upon success, MarkLogic Server returns a status code of 204 (No Content). If
the payload is malformed or the group does not exist, a status code of 400 (Bad Request) is
returned. A status code of 401 (Unauthorized) is returned if the user does not have the
necessary privileges.
Required Privileges
This operation requires the manage-admin role, or the following
privilege:
http://marklogic.com/xdmp/privileges/manage-admin
Usage Notes
The structure of the data in the request body is as
shown here. The only changable property is task-enabled.
threads
The maximum number of server threads allowed on each host in the group.
debug-threads
The maximum number of debugging threads allowed on each host in the group.
max-time-limit
The upper bound for a request's time limit, in seconds.
default-time-limit
The default time limit for a request, in seconds.
max-inference-size
The upper bound for a request's inference size, in megabytes.
default-inference-size
The default inference size for a request, in megabytes.
queue-size
The maximum number of tasks allowed.
pre-commit-trigger-depth
The maximum depth of pre-commit trigger invocation.
post-commit-trigger-depth
The maximum depth of post-commit trigger invocation.
pre-commit-trigger-limit
The maximum number of triggers a single statement can invoke.
file-log-level
The minimum log level for log messages in the log file.
log-errors
Log uncaught request processing errors to ErrorLog.txt.
debug-allow
Allow debugging on this server.
profile-allow
Allow profiling on this server.
scheduled-tasks
The scheduled tasks' specifications.
This is a complex structure with the following children:
scheduled-task
A scheduled task specification.
This is a complex structure with the following children:
scheduled-task-relations
The relations of the scheduled task.
This is a complex structure with the following children:
relation
A specific related resource.
This is a complex structure with the following children:
qualifiers
A list of associated resources that distinguish the resource.
This is a complex structure with the following children:
qualifier
Another resource that qualifies the resource.
This is a complex structure with the following children:
uriref
The path for a resource or list of resources.
typeref
The type of a resource or list of resources.
idref
The numeric identifier for the resource.
nameref
The name of the resource.
uriref
The path for a resource or list of resources.
typeref
The type of a resource or list of resources.
roleref
A role that distinguishes the resource.
idref
The numeric identifier for the resource.
nameref
The name of the resource.
relation-id
A group or host related to the server.
task-id
The task ID.
task-enabled
Whether or not a task is enabled
task-path
The module to invoke.
task-root
The path to the module directory root.
task-type
What type of scheduled task is this.
task-period
How often this task should run (every n months, weeks, days, hours or minutes).
task-month-day
The day of the month that this task runs on.
task-days
The days that this task runs on.
This is a complex structure with the following children:
task-day
A day that this task runs on.
task-start-date
The starting date (in MM/DD/YYYY notation) for this task.
task-start-time
The starting time (in 24:00 notation) for this task.
task-timestamp
The date and time this task was created.
task-user
The user to run this task as.
task-priority
The priority of this task.
Example
curl -X PUT --digest -u admin:admin \
-H "Content-type: application/json" -d '{"debug-threads":10}' \
http://localhost:8002/manage/v2/task-servers/Tserver/properties?group-id=Default
==> Sets the number of "debug-threads" on the 'Tserver' Task Server in the Default
group to 10.
Stack Overflow: Get the most useful answers to questions from the MarkLogic community, or ask your own question.
Stack Overflow: Get the most useful answers to questions from the MarkLogic community, or ask your own question.